home *** CD-ROM | disk | FTP | other *** search
/ PC Media 20 / PC MEDIA CD20.iso / share / udos / adder / adder.doc < prev    next >
Encoding:
Text File  |  1995-01-10  |  47.6 KB  |  1,053 lines

  1.  
  2.  
  3.  
  4.  
  5.  
  6.  
  7.  
  8.  
  9.  
  10.  
  11.                      DOCUMENTATION FOR ADDER
  12.  
  13.            COPYRIGHT TACHYON INC. ALL RIGHTS RESERVED
  14.                            JULY 1991.
  15.  
  16.  
  17.  
  18.  
  19.  
  20.                            TACHYON INC
  21.                           726 E 3800 N.
  22.                          PROVO, UT 84604
  23.  
  24.                        LICENSE AGREEMENT
  25.  
  26.      Since this is a demo program you can send this program to just
  27. about everyone you know. If you really like ADDER then send it to
  28. your best friends and customers. If you really hate this program
  29. then send it to your enemies, competitors or your mother in law.
  30. We aim to please so whatever happens ADDER should prove useful. However
  31. the Demo program and the full up adder are not the same beast. Whereas
  32. this can be legally thrown around at will, the registered version of ADDEr
  33. is protected by the copyright laws and may not be distributed.
  34.  
  35.  
  36.                            DISCLAIMER
  37.  
  38.      This program is good for nothing. In fact, we have barely
  39. heard of it. We don't certify that it will do anything or be good
  40. for any particular purpose. We don't know why you bought it, but
  41. we are sure it wasn't because of representations of ours. We will
  42. not be responsible if you lose money, lose time, lose your mind or
  43. lose anything as a consequence of using the program. If you know
  44. what warranties of merchantability are, it doesn't matter. We don't
  45. warranty anything, anyway; regardless of what happens, the only
  46. thing you can get from us is the money you paid for the program.
  47. We do acknowledge that there may be local laws that make all or
  48. part of this disclaimer nothing more than hot air. You may want to
  49. check on that. But, we doubt if you will.
  50.  
  51.                        TABLE OF CONTENTS
  52.  
  53. PREFACE. . . . . . . . . . . . . . . . . . . . . . . . . . . .  5
  54.  
  55. INSTALLATION . . . . . . . . . . . . . . . . . . . . . . . . .  7
  56.  
  57. OPERATION. . . . . . . . . . . . . . . . . . . . . . . . . . .  8
  58.  
  59. UP ARROW, DOWN ARROW, PAGE UP AND PAGE DOWN. . . . . . . . . . 10
  60.  
  61. LEFT AND RIGHT ARROWS. . . . . . . . . . . . . . . . . . . . . 11
  62.  
  63. HELP MENU. . . . . . . . . . . . . . . . . . . . . . . . . . . 12
  64.  
  65. AUTODECIMAL MODE . . . . . . . . . . . . . . . . . . . . . . . 13
  66.  
  67. AUTOLABEL MODE . . . . . . . . . . . . . . . . . . . . . . . . 14
  68.  
  69. AUTOSUBTOTAL MODE. . . . . . . . . . . . . . . . . . . . . . . 15
  70.  
  71. COMMA MODE . . . . . . . . . . . . . . . . . . . . . . . . . . 16
  72.  
  73. CLEAR ENTRIES. . . . . . . . . . . . . . . . . . . . . . . . . 17
  74.  
  75. DELETE ENTRY . . . . . . . . . . . . . . . . . . . . . . . . . 18
  76.  
  77. DELETE FILE. . . . . . . . . . . . . . . . . . . . . . . . . . 19
  78.  
  79. ESCAPE . . . . . . . . . . . . . . . . . . . . . . . . . . . . 20
  80.  
  81. GO TO AN ENTRY . . . . . . . . . . . . . . . . . . . . . . . . 21
  82.  
  83. INSERT ENTRY . . . . . . . . . . . . . . . . . . . . . . . . . 22
  84.  
  85. LABEL. . . . . . . . . . . . . . . . . . . . . . . . . . . . . 23
  86.  
  87. PERCENT. . . . . . . . . . . . . . . . . . . . . . . . . . . . 24
  88.  
  89. PRINT TAPE . . . . . . . . . . . . . . . . . . . . . . . . . . 25
  90.  
  91. RETRIEVE TAPE. . . . . . . . . . . . . . . . . . . . . . . . . 26
  92.  
  93. SAVE TAPE. . . . . . . . . . . . . . . . . . . . . . . . . . . 28
  94.  
  95. SUBTOTAL . . . . . . . . . . . . . . . . . . . . . . . . . . . 29
  96.  
  97. ADVANCED FEATURES. . . . . . . . . . . . . . . . . . . . . . . 30
  98.  
  99. BATCH COMPARE AND HOT COMPARE. . . . . . . . . . . . . . . . . 31
  100.  
  101. CLEAR TO ZERO. . . . . . . . . . . . . . . . . . . . . . . . . 33
  102.  
  103. RETRIEVE FROM LABELED VALUE. . . . . . . . . . . . . . . . . . 34
  104.                             PREFACE
  105.  
  106.      ADDER was conceived in a fit of spleen when the author
  107. discovered that he had to do his taxes. He then vowed to buy an
  108. adding machine so that the many and varied machinations necessary
  109. for the government to extract its exorbitant sums could be forever
  110. preserved for posterity. During the search, it occurred to our
  111. intrepid designer that he was the proud possessor of several of the
  112. most powerful adding machines ever created by man - computers. It
  113. only made sense then to acquire an adding machine program rather
  114. than an adding machine. It should have been more capable and
  115. cheaper than the standard adding machine. 
  116.      Alas, our hero searched in vain for the correct program. There
  117. were several calculators available but they didn't have the ability
  118. to store and retrieve tapes nor any of the editing that any
  119. reasonable adding machine program should provide. Only one program
  120. looked at all promising and that one was bundled with a bunch of
  121. unneeded stuff. 
  122.      Somewhat frustrated and grasping at any opportunity to avoid
  123. the dreaded tax task, our designer threw together a simple four
  124. function adding machine program with which his taxes were conjured
  125. and paid just under the wire.
  126.      However, given that our designer was blessed with a measure
  127. of the entrepreneurial spirit, he was seized by the conclusion that
  128. thousands of inventors before him must have thought - "Gee, if I
  129. need this there must be others who need it too". Brilliant! 
  130.      With this thought firmly planted in his mind, our newly
  131. energized programmer turned his efforts to the creation of the
  132. ultimate adding machine. The result has now come into your hands
  133. as ADDER. ADDER is the first cut. As with all such slices, many
  134. more versions and capabilities are yet to come. Indeed, some ideas
  135. were left out simply to arrive at some reasonable point at which
  136. to ship the program. To be fair, our hero was also getting some
  137. pressure from his better half to make some money off this project
  138. on which he had been spending all his time.
  139.      So, here it is. Since innovation always encourages
  140. duplication, we have no doubt that at some point competition will
  141. raise its All-American head and attempt to capture some of our
  142. market. If we can stay ahead, so that the bad guys are always
  143. playing catch-up, we can maintain what early lead we have been able
  144. to achieve. For that reason (pure self interest), we want to hear
  145. from you. Tell us what you like. Tell us what you don't like
  146. (please be nice; we are sensitive). Tell us what other features you
  147. would like to see. We will collect the best suggestions (or the
  148. most frequently requested) and create ADDER II or III or whatever.
  149.      I apologize ahead of time for the informal, somewhat whimsical
  150. and rambling style that you will find in this manual. I find it
  151. hard to take things seriously. I have also read too many dull
  152. manuals to add another one, of my own making, to the world's
  153. collection. Who knows, if it's not too dull maybe you'll even read
  154. it. Thanks, need to be added here to Judy Binkley for her editing
  155. and final proof reading.
  156.      I hope you will be pleased with our efforts. If you're not,
  157. we hope you won't ask for your money back. But, if you do, what the
  158. heck; life is too short to worry about money. Right? I know. I
  159. know. I don't believe that either. INSTALLATION
  160.  
  161.      All you have to do to install ADDER is copy the contents of
  162. the disk into the directory where you want it. Some variation of
  163. copy a:*.* C:\DOS should work just fine. 
  164.      However, as with most simple things in life, there is a
  165. gotcha. The files from this disk should be placed in a directory
  166. that is on the PATH list of your computer. Here is where things
  167. could get tricky. The path variable is set up in the DOS
  168. environment. If you want to see what PATH is set to, all you have
  169. to do is type SET at the DOS prompt. But, that doesn't help you
  170. change it. All that does is show you what is in the DOS path. If
  171. your computer is set up in any reasonable way, most of your DOS
  172. commands will be in a single directory and that directory will be
  173. in the DOS path. That is a good place to put the files from your
  174. ADDER disk. I heartily recommend that.
  175.      If you absolutely must create a new directory for your ADDER
  176. files, then that directory must be added to the PATH list. For
  177. information on how to accomplish that, your best bet is either to
  178. look it up in your DOS manual (perish the thought), or call your
  179. local computer type (the guy who sold you the thing) and ask
  180. him/her how to add a directory to your PATH. Yes, the answer is a
  181. bit tricky or I would have explained here. But, any savvy computer
  182. gal or guy should be able to walk you though it with minimum
  183. difficulty.
  184.  
  185.                            OPERATION
  186.  
  187.      ADDER is designed to be easy to use. Of course, what will seem
  188. easy to your local computer freak, may be totally incomprehensible
  189. to a normal human being. We hope that anyone who has ever used an
  190. adding machine will be able to run and use ADDER with little or no
  191. training. 
  192.      To run ADDER, type "ADDER" at the DOS command line. Pretty
  193. easy, huh? If ADDER comes back with some message like "The system
  194. message library file SyS$sys.dat could not be opened", that means
  195. that the support files that ADDER needs (they should be on your
  196. distribution diskette) have not been placed in the DOS path. ADDER
  197. tries to hunt them down as soon as he comes up and if he doesn't
  198. find them, he barfs up a message and refuses to run. You need to
  199. install these files in some directory that is in the DOS path. If
  200. this error occurs, go back to the installation section of this
  201. manual, do not pass GO and do not collect $200.
  202.      Assuming that ADDER comes up, the only thing you really need
  203. to remember is that if you ever end up in a situation where you do
  204. not want to be, press the Escape key. Well, not every situation.
  205. Escape won't do much for a bad marriage. You need either
  206. communication, sensitivity, counseling or a good lawyer for that.
  207. But, in almost any situation in which ADDER can get you, Escape
  208. should back you out of whatever you are doing to some more normal
  209. state. 
  210.  
  211.      There are 5 available mathematical operations.
  212.  
  213.      + = add
  214.      - = subtract
  215.      * = multiply
  216.      / = divide
  217.      ^ = power of 
  218.  
  219.      There is also an operation modifier
  220.  
  221.      % = Percent
  222.  
  223.      ADDER works the same way an adding machines does. For you
  224. formal buffs that means postfix. For those of you who just want it
  225. to work right, postfix means that the operation (+,-,*,/,^) applies
  226. to the number of the entry on which the operation is found. If that
  227. didn't make any sense a few examples should clear things up.
  228.  
  229.                The sequence:
  230.  
  231.                               1 +
  232.                               2 -
  233.                               3 *
  234.                               1 -
  235.                               4 /
  236.                               5 ^
  237.  
  238. would sum to -1 or (+1-2*3-1/4^5). In other words, when you enter
  239. a number, ADDER still doesn't know what to do with it until you
  240. put in some kind of operation (+ - / * ^). There is no precedence
  241. (you know * and / done before + and -)  to the operators. The
  242. operations are executed from top to bottom.
  243.      There is one more thing you should know. To input a negative
  244. number, you need to enter the "-" (minus sign) right at the
  245. beginning of the number. After the first number is entered, ADDER
  246. will assume that a minus sign means the operation of subtraction
  247. and not the sign, minus.
  248.      OK, now it gets a bit tricky. ADDER does a number of snazzy
  249. things (we call them functions, but then we're techie types) that
  250. you will never have seen on an adding machine before. Let me give
  251. you a couple of words of advice on how to learn about these
  252. functions. In fact, this method will well work with most any
  253. program. Open the manual to a given function. Read the section,
  254. then try it. There is a concept called the engineering mentality.
  255. The engineering mentality means simply that one has the curiosity
  256. to play with something until certain truths about the object,
  257. program, concept or whatever start falling out. If you will sit
  258. down with ADDER and start playing around with the various
  259. functions, whatever mystery that might exist will quickly vanish
  260. and the program will begin to seem like an old friend. Don't worry
  261. about screwing something up. It is possible, but very unlikely. In
  262. any case, the possibility of a short term loss is overcome by the
  263. long term gain of learning the system.  
  264.      You will see the term "Hot Key" mentioned in this manual. "Hot
  265. Key" simply refers to the quick way of getting to a function. You
  266. can always get to the functions from the Help Menu. But the "Hot
  267. Keys" start the function by pressing only a single key. For
  268. example, if you want to label an entry, you could press "L".
  269.      Computers and computer programs are just like cookbooks. There
  270. are certain ways to accomplish (make) things. If you don't know the
  271. recipe, you can't get there from here. But, once you learn the
  272. system, it seems simple and straightforward. Above all, don't be
  273. afraid of it. Try it out. If it doesn't seem to work the first
  274. time, then try different things until it does what you want.
  275.           UP ARROW, DOWN ARROW, PAGE UP AND PAGE DOWN
  276.  
  277.      The up and down arrows move you up and down the tape window.
  278. The up and down arrows also move you up and down any menu you
  279. happen to pop up. Page up and page down will also move you up and
  280. down tapes or menus. Page up and down simply take bigger leaps.
  281.  
  282.                      LEFT AND RIGHT ARROWS
  283.  
  284.      The left and right arrows move you from the right tape window
  285. to the left one and vice versa. In other words, if you want to move
  286. to the right tape window, you press the right arrow. So, if you are
  287. in the left tape window and press right arrow you will move to the
  288. right tape window. If you are in the right tape window and press
  289. the left arrow, you will move to the left tape window . However,
  290. if you are already in the left tape window and you press the left
  291. arrow nothing will happen. Conversely, if you are already in the
  292. right tape window and you press the right arrow nothing will
  293. happen.                     HELP MENU
  294.  
  295. HOT KEYS: F2, F3, F4, F5, F6, F7, F8, F9
  296.  
  297.      These function keys all do the same thing. They select the
  298. Help Menu. The help menu lists all of the functions that are
  299. available in ADDER. 
  300.      If you are like me you hate to memorize anything. When you
  301. memorize a command or name (I'm still terrible with names) it's
  302. mainly because of repetition. Because of this and because some of
  303. the function keys from the keyboard don't seem to relate to the
  304. function, I devised this combination of a help and executable menu.
  305.      When you press one of the listed function keys the help menu
  306. will pop up. This menu will always pop up on the side away from
  307. where you are working. That's so you can see what you were working
  308. on. The Help Menu will show you all of the functions as well as
  309. their hot keys.
  310.      If you want to execute a function from the Help Menu, you
  311. point and shoot. To do this you only need to press one of the
  312. function keys F2-F9. Once you have brought up the Help Menu you
  313. use the up and down arrows to indicate which function you want to
  314. execute. When you have highlighted the function, you simply press
  315. the Enter key. The selected function will execute as if you had
  316. pressed the hot key.
  317.      
  318.                        AUTODECIMAL MODE
  319.  
  320. HOT KEY:  A    
  321.  
  322.      Autodecimal mode means that ADDER will assume that all entries
  323. have the specified number of decimal places after the decimal
  324. point. If the selected number of decimal places is two, then two
  325. of the entered digits will be considered as being to the right of
  326. the decimal point. 
  327.      This mode is entered by pressing the "A" key on the keyboard
  328. and then selecting the mode from the menu. Autodecimal mode can
  329. also be selected from the Help Menu. This mode is a toggle. That
  330. means that when you select it the first time it will turn
  331. Autodecimal mode on. When you select it the second time it will
  332. turn the mode off, third time on, fourth time off, etc. When
  333. Autodecimal mode is first turned on ADDER will ask how many digits.
  334. ADDER is asking for the number of digits to the right of the
  335. decimal point. 
  336.      I can tell by reading this over that it isn't making a ton of
  337. sense, so let's try an example.
  338.      If you had selected Autodecimal mode and selected 2 as the
  339. number of digits, your next input would look like something like
  340. this:
  341.  
  342.                          .0
  343.  
  344.      If the numbers 1,2,3,4,5,6 were entered the display would
  345. progressively look thusly:
  346.  
  347.  
  348.                          0.01
  349.                          0.12
  350.                         01.23
  351.                        012.34
  352.                       0123.45
  353.                      01234.56
  354.  
  355.      In other words, with Autodecimal Mode on, ADDER assumes that
  356. the number that you are entering will have two decimal places in
  357. it.
  358.      This feature is useful when one is entering dollar values. By
  359. turning on Autodecimal mode, one can dispense with entering the
  360. decimal point since every number will be assumed to have one.
  361.  
  362.  
  363.                         AUTOLABEL MODE
  364. HOT KEY:  A    
  365.  
  366.      This mode is entered by pressing the "A" key on the keyboard
  367. and then selecting the mode from the menu. You can also select
  368. Autolabel on the Help Menu. This mode is a toggle. That means that
  369. when you select it the first time it will turn Autolabel mode on.
  370. When you select it the second time it will turn the mode off, third
  371. time on and fourth time off etc.
  372.      This one is easy. So easy in fact that I'm not really going
  373. to explain it here. Not really. The only thing that this mode does
  374. is to force a label for every entry. You might want to use this
  375. when you are entering a series of checks and you wish to indicate
  376. the check number on every entry.
  377.      If you want to learn more about what this will do, consult the
  378. Label function. 
  379.  
  380.  
  381.                        AUTOSUBTOTAL MODE
  382. HOT KEY:  A    
  383.  
  384.      This mode is entered by pressing the "A" key on the keyboard
  385. and then selecting the mode from the menu. You can also get there
  386. from the Help Menu. This mode is a toggle. That means that when you
  387. select it the first time it will turn Autosubtotal mode on. When
  388. you select it the second time it will turn the mode off, third time
  389. on and fourth time off, etc.
  390.      This is kind of a fun mode. When Autosubtotal mode is on, a
  391. subtotal is automatically shown after every entry. This is a useful
  392. feature for balancing a checkbook. Since most people enter a
  393. subtotal after every check or deposit, Autosubtotal will do it
  394. without any extra effort.
  395.      If you are not sure how Subtotal functions, you can look it
  396. up under Subtotal.
  397.  
  398.  
  399.                           COMMA MODE
  400. HOT KEY:  ,    
  401.  
  402.      You can toggle in and out of Comma mode by pressing the ","
  403. key. The Help menu gets you there, too.
  404.      I put this in out of spite and because I couldn't admit that
  405. I was wrong. While I was working on ADDER I took every opportunity
  406. to show what I was doing to the uninitiated. In other words, I
  407. showed ADDER to folks who had little experience with a computer to
  408. make sure that everything was kept simple. There was no one more
  409. uninitiated than my wife. She refuses to lay a finger on a
  410. computer. She is convinced that computers are a male chauvinistic
  411. plot to give husbands an excuse to ignore their wives. Her first
  412. comment on seeing my creation was to say: "There aren't any commas
  413. in the numbers. I can't tell what the numbers are." My finest
  414. creation was shot down in flames. 
  415.      Since the programming language in which I wrote ADDER does
  416. not automatically allow such trivialities, I had to create an
  417. algorithm to stick in commas. I couldn't admit that everyone would
  418. want commas, so I stuck in a way to take the commas out. 
  419.      Hence, Comma mode will turn the commas off and on in the
  420. number presentation. I justified myself on this one by deciding
  421. that there may be some scientific type or maybe just somebody
  422. crazy, like my Aunt Nita, out there who has something against
  423. commas. If someone likes this toggle please let me know. At least
  424. then I can tell my wife that I told her so.
  425.                          CLEAR ENTRIES
  426. HOT KEY:  C    
  427.  
  428.      This function is initiated by pressing a 'C' or by selecting
  429. Clear Entries from the Help menu. This function clears out all of
  430. the entries from the tape. Clear Entries function should be done
  431. very carefully since it will wipe out whatever you were doing.
  432. Since there could be a minor catastrophe if this were accidentally
  433. selected, Clear Entries requires a confirmation. When Clear Entries
  434. is selected ADDER will ask:
  435.  
  436.           Clear out the entries
  437.           NO
  438.           YES
  439.  
  440.      If you select YES then all of the entries will be cleared out.
  441. If you select NO then nothing will change.
  442.           
  443.                          DELETE ENTRY 
  444. HOT KEY:  D, DEL    
  445.  
  446.      This one is nice and easy. You initiate Delete Entry by
  447. another intuitive command, "D". But, this one has a twist. Since
  448. most computer keyboards have a "DEL" key, it seemed only
  449. appropriate to include the "DEL" key in the Delete command. Not
  450. wanting to be branded inappropriate (along with my other brands),
  451. it is indeed possible to Delete an entry by pressing the "DEL" key
  452. as well as the "D" key. Then, just to put the frosting on the cake,
  453. you can also get there from the HELP menu.
  454.      Guess what? The Delete Entry command deletes an entry. Delete
  455. Entry is the grim reaper of ADDER, in that nothing is safe from it.
  456. Anything you can enter, you can delete. So, if you want to delete
  457. a subtotal, go for it. If a Clear to Zero incurs your displeasure,
  458. Delete will solve the problem. Oh yeah, Delete does not leave an
  459. empty space, it pushes everything else up.
  460.                           DELETE FILE
  461. HOT KEY:  K    
  462.  
  463.      The "K" that is used to initiate this function stands for Kill
  464. file. Really! 
  465.      When you press "K" or initiate the function through the Help
  466. Menu, ADDER will ask you what directory you want. Once you tell
  467. ADDER the directory, ADDER will present you with a list of the tape
  468. files that are in that directory. Then again, it is a matter of
  469. point and shoot. Move the highlighting up or down with the up and
  470. down arrows until you have highlighted the file that you want and
  471. then press Enter. That file will be deleted (killed) from the disk.
  472.      If you get into this function by mistake and decide you really
  473. didn't want to kill any files, just press the all pervasive Escape
  474. key to get out.
  475.                             ESCAPE
  476. HOT KEY:  ESC  
  477.  
  478.      Everyone should have an Escape key. This key is the "Help Mr.
  479. Wizard" of ADDER. If you get somewhere that you don't want to be
  480. and you want to back up and cancel the function, press the "ESC"
  481. key. Think how useful this would be in real life. If you screwed
  482. up in life, you could just hit your escape button and back up to
  483. before the place that you screwed up and begin again. Of course,
  484. some of us would have to back up for years (at least that's what
  485. my wife tells me), so I suppose even the Escape key has its
  486. limitations.
  487.      I have tried to program the Escape key so that it would work
  488. everywhere and in a predictable fashion. If you find a place where
  489. it doesn't work, or the way it works is counterintuitive (I love
  490. that word), please, drop us a card or letter with your suggestion.
  491.                         GO TO AN ENTRY
  492. HOT KEY:  G    
  493.      
  494.      "G" is for Go to. That's pretty simple. So is the function.
  495. You can go to any entry by pressing the "G" key or by selecting the
  496. function from the omniscient Help Menu. You will then be prompted
  497. by ADDER for the entry number where you want to go. You type in
  498. the entry number and, zappo, you're there. That means that the
  499. selected entry number is now highlighted and can be modified. If
  500. you select an entry number that is larger than the largest entry
  501. number, then ADDER takes you to the end of the tape and leaves you
  502. there.
  503.      I envisioned this to work in conjunction with the Batch
  504. compare function. The Batch compare tells you which entries were
  505. wrong. By using the Go To function you can go straight to the
  506. entries that were wrong (or at least different).
  507.  
  508.                          INSERT ENTRY 
  509. HOT KEY:  I, INS    
  510.  
  511.      While Delete Entry serves as the bad guy of ADDER, Insert
  512. Entry is the good guy. By pressing (what else) "I" you can place
  513. a completely unused empty space above the entry that is
  514. highlighted. This function has the same twist as Delete in that
  515. there is an INS key on the keyboard. It was only poetically proper
  516. that INS should be allowed to Insert also, so it does. Need I
  517. mention that the Help Menu will also do this? 
  518.      The space created by Insert can be filled by whatever your
  519. heart desires (within the capabilities of ADDER at least).
  520.                              LABEL
  521. HOT KEY:  L    
  522.  
  523.      Label is an interesting feature. If you have used one of the
  524. more expensive adding machines, you may already be familiar with
  525. it. Using this feature you can place some human readable symbols
  526. to identify what might otherwise be simple numbers. On the other
  527. hand, you may also be able to entangle the entire area with
  528. indecipherable acronyms, false leads and abbreviations. Whether to
  529. conceal or clarify, the Label function should prove a convenient
  530. tool.
  531.      One may initiate the Label function by using the Help menu or
  532. by pressing the "L" key on the keyboard. Once in the label function
  533. you may enter any combination of 8 (Don't get grouchy; there has
  534. to be a limit somewhere) letters, numbers or whatever. All letters
  535. will be converted to capitals. This is for the convenience of the
  536. Memory Recall feature which you can read about under the advanced
  537. (that is, unnecessary, but fun) features of ADDER.
  538.      To terminate the label function just press the Enter key. If
  539. you decide that you made a mistake and don't want a label after
  540. all, just press the Escape key and the label will not be saved. If
  541. you have a label on an entry already and you would like to change
  542. it, simply move to the entry with the undesired label, press "L"
  543. and you can edit the label that you put on the entry. In this way
  544. you can also eliminate the label if you are so inclined. You move
  545. to the entry with the label,  press "L" and then you can press
  546. ESCAPE and the label will disappear or (if you like long ways to
  547. do things) you can backspace until there is no more label and then
  548. press ENTER.
  549.      Once in the all controlling Label function however, all of our
  550. other functions take the day off. This means that if you are busily
  551. entering a label and then you decide you'd really like to do a
  552. Subtotal, forget it. Label will assume that the "=" key was meant
  553. to be a symbol in the label. The same will be true of " A,G,H " or
  554. any other hot key that is normally a function. 
  555.      The bottom line is if you want to execute any of the functions
  556. you must get out of the LABEL function with either an ESCAPE or an
  557. ENTER key.
  558.      The reason for this is simple. If the functions were still
  559. active you could never enter the label "ASSETS". If the functions
  560. were still active, as soon as you pressed the "A" ADDER would
  561. presume that you wanted to initiate or terminate one of the
  562. automatic modes and would put that menu on the screen. The same is
  563. true of the "S". If the functions were active "S" would initiate
  564. the function to save the tape. So there really is a reason for this
  565. madness.
  566.      Label is useful for such things as check numbers, labeling
  567. Subtotals (like assets) or whatever. Yes, I know you are limited
  568. to 8 characters so you can't write a book or anything. If you want
  569. to use Label a lot, you may want to come up with a uniform set of
  570. abbreviations, so that anyone who retrieves your tape will have
  571. some idea of what is going on. PERCENT
  572. HOT KEY:  %    
  573.  
  574.      The percent key is a toggle. The first time it is used it will
  575. turn the percent function on and a percent sign will appear beside
  576. the number. The second time it is used on a particular entry the
  577. percent key will be turned off.
  578.       The percent key does percents. Pretty tricky? It isn't quite
  579. as simple as it looks, however. The percent key works differently
  580. depending on which operation you are using. With + and -, the
  581. percent key works differently than with * and /. Percent has no
  582. effect on ^ (power). With * and /, all the percent key does is
  583. divide its number value by 100.
  584.  
  585.      e.g.      50  +
  586.                50% *
  587.  
  588.      would equal 25 (or 50 * .50 = 25). This is the equivalent of
  589. saying what is 50 percent of 50.
  590.  
  591.      e.g.      50  +
  592.                50% /
  593.  
  594.      would equal 100 (or 50 / .50 = 100). This is the equivalent
  595. of 50 divided by 50%.
  596.  
  597.      With + and -, ADDER will take the percentage of the subtotal
  598. to that point and either add or subtract depending on which you
  599. choose.
  600.  
  601.      e.g.      50  +
  602.                50% +
  603.  
  604.      would equal 75 or ( or 50 + (50% of 50) = 75). This is the
  605. equivalent to the sum of 50 plus 50 percent of itself.
  606.  
  607.      e.g.      50  +
  608.                50% -
  609.  
  610.      would equal 25 or ( or 50 - (50% of 50) = 25). This is the
  611. equivalent to the sum of 50 minus 50 percent of itself.
  612.      Remember that the + or - percent takes the percentage of the
  613. subtotal to that point and not just the previous entry.
  614.  
  615.      e.g.      50  +
  616.                50  +
  617.                50% +
  618.  
  619.      would equal 150 (or + 50 + 50 + (50 % of 100) = 150.
  620.  
  621.      You might want to play with this a bit before you feel like
  622. you have your feet down.   PRINT TAPE
  623. HOT KEY:  P    
  624.  
  625.      You can print a tape by simply pressing "P" on the keyboard,
  626. or through the ubiquitous Help menu. After pressing the "P"
  627. command, the computer will ask you what you want to name the tape.
  628. We figure every tape should have a name when it is immortalized to
  629. hard copy. If you really want an unnamed tape, just press Enter at
  630. the name prompt without typing in a name. Then the tape will not
  631. have a name, or more precisely the tape name will be blank. All of
  632. the entries will print anyway (sorry there's no way to turn that
  633. off).
  634.      ADDER will assume that you have a printer that handles 8 1/2
  635. X 11 paper (that's all I have) and will print double columns of
  636. entries. The entries will be numbered for easy reference and the
  637. pages are numbered also with the tape name appearing on each page.
  638.      For you techie types who may want to play games with the
  639. printing, the printing is directed to \LPT1.  We figured most folks
  640. wouldn't want to mess with which printer so we tried to simplify
  641. it. If this turns out to be a problem, let us know.
  642.      It is important to note that the only tape that will print (at
  643. least at press time) is the tape in the window that is active.
  644. Yeah, I know that didn't make a lot of sense. Functionally what it
  645. means is that if you want to print a tape that is stored on the
  646. disk you will have to retrieve it into one of the tape windows and
  647. then print it. 
  648.                          RETRIEVE TAPE
  649. HOT KEY:  R    
  650.  
  651.      Well, saving tapes isn't worth a hoot if you can't retrieve
  652. the puppies. The hot key for retrieving tapes is (hold on to your
  653. hat) "R". What a surprise! As you already know the Help menu can
  654. get you there too.
  655.      After pressing the "R" key, ADDER will want to know what
  656. directory you want. ADDER will assume the current directory and
  657. will put that on the editing line. But, as we say in law, the
  658. current directory is a rebuttable presumption. Our valued ADDER
  659. user can rebut that presumption by pressing backspace to wipe out
  660. parts of the line or by adding to it or by some combination of the
  661. two. Press Enter when you are done and ADDER will search for all
  662. of the tape files that are in that directory and display them for
  663. your selection.
  664.      If, at this late date you don't know what a directory is, then
  665. shame on you. You need to learn what a directory is. While you're
  666. at it take a couple of law courses.
  667.      You can then move the highlighting to the tape you want to
  668. retrieve and press Enter. The tape will be retrieved into whichever
  669. tape (left or right) that you were in at the time. If there is
  670. already something in that directory, then ADDER will ask if you
  671. want to insert the tape file into the tape or simply overwrite what
  672. is already there. If you insert the tape file from disk, ADDER will
  673. put the contents of the tape file that is on the disk exactly where
  674. the cursor is. An inset would look like this:
  675.  
  676.  
  677.  
  678.                          1  +
  679.                          2  +
  680.                ->        3  +  <- highlighting is here
  681.                          5  +
  682.                          6  +
  683.  
  684.      If you want to retrieved a tape file from the disk which
  685. contains:
  686.  
  687.                          7  +
  688.                          8  +
  689.                          9  +
  690.  
  691.      and you answer INSERT to the question of INSERT OR OVERWRITE
  692. then the resulting tape would look like this:
  693.  
  694.                          1  +
  695.                          2  +
  696.                ->        7  +  < - highlighting is here
  697.                          8  +
  698.                          9  +
  699.                          3  +  
  700.                          5  +
  701.                          6  +
  702.  
  703.      CAUTION             CAUTION             CAUTION
  704.  
  705.      When a tape is retrieved, and overwrite is selected, ADDER
  706. will completely overwrite anything that was already on screen.
  707.      Remember our friendly Escape key will bail out of this
  708. function with no damage done.
  709.  
  710.                            SAVE TAPE
  711. HOT KEY:  S    
  712.  
  713.      We struggled long and hard for the right key for this one
  714. before someone suggested "S". You can also get there from the Help
  715. menu. Are you getting tired of hearing that? This is some serious
  716. extra capability that you can't get with any run of the mill,
  717. generic, turn of the century style, adding machine. If you want to
  718. save your tapes for posterity, later comparison, modification, in
  719. case the IRS audits you or just for the heck of it, you can now
  720. save these tapes painlessly on your computer disk drive. 
  721.      Yessiree, step right up ladies and gentlemen, because when you
  722. press "S", the machine will ask for the name of the file you want
  723. to put it in. Once that piece of information has been entered,
  724. ADDER will check to see if such a file already exists. If not, then
  725. ADDER will create the file and write the information. If there
  726. already is a file by that name, then ADDER will ask if you want to
  727. overwrite that file. If you answer "YES", then ADDER will go ahead
  728. and write over the top the file. If you answer "NO" then ADDER will
  729. forget the whole thing. We just wanted to make sure you didn't
  730. crunch something important by mistake.
  731.  
  732.  
  733.  
  734.                             SUBTOTAL
  735. HOT KEY:  =    
  736.  
  737.      A Subtotal is entered by selecting Subtotal from the Help Menu
  738. or by pressing an equals "=" sign. A Subtotal does what you would
  739. expect. It takes the value at the particular point in the tape
  740. where the subtotal is placed. Unless a subtotal is requested at an
  741. entry that is empty (has no operation), a subtotal request will
  742. always do an insert before it does the subtotal so you don't have
  743. to worry about overwriting a entry. Lets look at an example or two.
  744.  
  745.      If your tape looked like this:
  746.  
  747.                          1  +
  748.                          2  +
  749.                          4  +  <- highlighted here
  750.                          5  +
  751.                         12 SUB
  752.                          6  +
  753.                          7  +
  754.  
  755.      and you requested a SubTotal. You would end up with this:
  756.  
  757.                          1  +
  758.                          2  +
  759.                          3 SUB
  760.                          4  +
  761.                          5  +
  762.                         12 SUB
  763.                          6  +
  764.                          7  +
  765.  
  766.      A Subtotal will change when the values above the subtotal are
  767. changed or another is inserted. For example if a value is added
  768. above the subtotal entries:
  769.  
  770.  
  771.                         11  -  <- added entry
  772.                          1  +
  773.                          2  +
  774.                         -8 SUB
  775.                          4  +
  776.                          5  +
  777.                          1 SUB
  778.                          6  +
  779.                          7  +
  780.  
  781.      The Subtotals will also change to reflect the new entry.
  782.                        ADVANCED FEATURES
  783.  
  784.      Once upon a time, when I was taking a semi-difficult math
  785. class in college I read a phrase in the math book that I have
  786. always remembered. It read: "Now we are going to make a radical
  787. generalization." It was at that point that the whole world turned
  788. into a vector, good old 3 space disappeared into n space and my
  789. brain turned rapidly to tapioca pudding. I don't even like tapioca
  790. pudding.
  791.      I've always wanted to write this in a book so here it comes:
  792. "Now we are going to make a radical generalization". Another
  793. lifetime goal achieved!! Actually, these are just some fun things
  794. that may or may not prove useful to you. The first two are pretty
  795. straight forward, but will really help the folks that run two tapes
  796. of things and then compare the results. These two are Batch and Hot
  797. Compare.
  798.      The next two make for some really interesting possibilities.
  799. These two are Clear to Zero and Retrieve From Labeled Value.
  800.      If you are reading this manual cover to cover (has anyone ever
  801. done that?) you can feel free to stop now. Pause! Pause! OK, if
  802. you're going to read on try to think of ADDER as a programming
  803. system more than just an adding machine and let's press on.
  804.  
  805.                  BATCH COMPARE AND HOT COMPARE
  806.  
  807. BATCH COMPARE HOT KEY: B
  808.  
  809. HOT COMPARE HOT KEY : H 
  810.  
  811.      I was going to call the Hot compare Real Time compare but Hot
  812. compare is a good short description and "H" was not yet used as a
  813. hot key, while "R" was. So, I figured what the heck. "B" is
  814. straight forward for Batch compare and, of course, these functions
  815. are available through the Help Menu. That's how I generally get
  816. there when I use them. These functions compare two tapes against
  817. each other to determine if they are identical. 
  818.      From way back in my accounts receivable days, I recall running
  819. two tapes of entries and hoping they would come out identically.
  820. If they didn't then I had to compare entry by entry to discover
  821. which entry was different. As you have probably guessed by now, the
  822. two compare functions will do that for you. 
  823.      These are somewhat dumb compare functions, in that they will
  824. expect the entries to be identical and in the identical positions.
  825. In other words, if you input:
  826.  
  827.                     1 +
  828.                     2 +
  829.                     3 +
  830.  
  831. for one tape and
  832.  
  833.                     1 +
  834.                     3 +
  835.                     2 +
  836.  
  837. for the next, ADDER will flag entry numbers 2 and 3 as different
  838. even though the net effect is the same.
  839.      The compare functions also compare the operators. In other
  840. words:
  841.  
  842.                     2 +
  843. and
  844.                     2 -
  845.  
  846. will be flagged as different. It also means that Sub Totals will
  847. be checked as well as Percents and Clear To Zero. So when the
  848. compare functions want the tapes to be identical they really must
  849. be identical. The compare functions however, don't give a hoot
  850. about labels.
  851.  
  852.                           BATCH COMPARE
  853.  
  854.      For those of you who are old timers in the data processing
  855. world you might recognize a "batch" process as something that is
  856. done by a giant blue machine which is served by squadrons of
  857. attendants while you wait until the monster spits up the output.
  858. That is sort of how this compare operates. 
  859.      To use the Batch Compare you should first input all of the
  860. entries in both copies of the tape that you want to compare and
  861. store them on the disk. You then select the Batch Compare function
  862. which will ask you for the names of the two tapes you want to
  863. compare. The Batch Compare will pull in both copies of the tape and
  864. compare them entry by entry for differences. When the computer has
  865. completed the compare, ADDER will put up a display indicating that
  866. the tapes were identical or, if they weren't,  which entries were
  867. different. You can use the up and down arrow keys to move through
  868. the display of which entries were different.
  869.  
  870.                            HOT COMPARE
  871.  
  872.      When Hot Compare is engaged each entry you input into the
  873. ADDER will be compared against a tape that was previously stored
  874. to the disk. The truth is that when Hot Compare is on, even if you
  875. are just moving through the tape on the screen, each of the entries
  876. will be compared against the selected tape on the disk.
  877.      Hot Compare means you don't have to wait to discover if an
  878. entry that was just input is different from the corresponding entry
  879. of another tape. If it is different, the computer will beep at you
  880. and show you what the value is on the stored tape as the entry is
  881. scanned or entered.
  882.      Keep in mind also that Hot Compare is a toggle. That means to
  883. turn it off you have to select the function again. So if you are
  884. in the middle of a Hot Compare and you decide that you are
  885. finished, you would press "H" again and the Hot Compare will end.
  886. There is one other way to get out of Hot Compare and that is to
  887. select the other tape (you remember there are always two tapes
  888. visible). So if you press the arrow key to switch to the other
  889. tape, Hot Compare will end.
  890.      A fun way to play with this feature is to create a tape and
  891. then save it to disk. Then, turn Hot Compare on with the comparison
  892. tape being the one you just saved to disk. Naturally all of the
  893. entries will be equal. Not being happy with symmetry, you then
  894. change a few entries to see how ADDER reacts. ADDER will tell you
  895. that the entries were different and what the entry was on the disk.
  896.                          CLEAR TO ZERO
  897. HOT KEY:  Z    
  898.  
  899.      Clear to Zero is initiated by  pressing a "Z" or by selecting
  900. it from the Help menu. Clear to Zero is like the invention of the
  901. wheel. It is simple, but allows all kinds of flexibility. Clear to
  902. Zero will first do a subtotal and then it will enter Clear to Zero
  903. in the next line. This function effectively ends the tape at this
  904. point. You can insert values above it or delete them or change the
  905. values and the tape value will change. But, nothing will change
  906. below the Clear to Zero. But, you can start an entirely new tape
  907. below the Clear to Zero which is independent of the one above it.
  908.      I can tell by rereading the above paragraph that this
  909. explanation isn't entirely clear. The best way to figure it out is
  910. to try it out on ADDER. But, if you are a manual freak and you want
  911. to put me through some more work then here is an example:
  912.  
  913.  
  914.  
  915.                                    1 +
  916.                                    2 -
  917.                                    5 +
  918.                                    8 *
  919.                                   10 +
  920.                                   42 SUB
  921.                         Clear to Zero
  922.                                    9 -
  923.                                    5 +
  924.                                   12 +
  925.                                    8 SUB
  926.  
  927.      So you see that essentially you have two separate tapes. One
  928. before the Clear to Zero and one after. If we then change some
  929. entry on the upper tape:
  930.  
  931.                                    1 +
  932.                                    2 -
  933.                                    5 +
  934.                                    8 *
  935.                                   20 +   <- we changed this entry
  936.                                   52 SUB < - this changed
  937.                         Clear to Zero
  938.                                    9 -
  939.                                    5 +
  940.                                   12 +
  941.                                    8 SUB <- this didn't
  942.  
  943.      The upper subtotal (tape) will change but the lower doesn't.
  944. In other words, we really have two independent tapes that can be
  945. separately modified.
  946.                   RETRIEVE FROM LABELED VALUE
  947. HOT KEY:  M
  948.  
  949.      Now, we have the feature that makes Clear to Zero really work.
  950. OK, we have a weird key to initiate this one. It is "M". There is
  951. actually some history here. I had thought to make this a memory
  952. function. But, after thinking about it, it seemed silly to create
  953. a separate (and hidden) class of memory (as on calculators and
  954. such) when ADDER has multiple slots for memory already, which are
  955. visible. So, if there is a value that you really want to save or
  956. call back at some future time just put a label on it. Then when you
  957. want it back, type "M" on the keyboard and ADDER will ask you what
  958. labeled item you want to retrieve. 
  959.      If you haven't already guessed, this creates some intriguing
  960. possibilities. For example, if you have a bunch of constants that
  961. you want to maintain, and call them back periodically, you can do
  962. the following:
  963.  
  964.           PI         3.1415  + 
  965.           PLANKS    6.23232  + (Sorry, this isn't the actual value)
  966.           C         365,000  +
  967.               365,009.37382 SUB
  968.         ** Clear To Zero **
  969.                           4  +
  970.                           2  ^                    A = πr2
  971. M      PI            3.1415  *
  972.                      50.264 SUB
  973.         ** Clear To Zero **
  974. M       C           365,000  +
  975.                           2  ^                    E = mc2        
  976.                        2.26  *
  977.             301,088,500,000 SUB
  978.  
  979.  
  980.      Pretty neat huh, and all done with an adding machine.
  981.  
  982.      For those of us who have to work in the more mundane world of
  983. dollars and cents. We have the balance sheet. What? You say. A
  984. balance sheet from an adding machine?. Well of course! I did say
  985. that these were advanced features. 
  986.      Here is a simple balance sheet:
  987.  
  988.                                12  +
  989.                                10  +
  990.                                30  +
  991.                             23.21  +
  992.                             19.95  +
  993.       CASH                  95.16SUB
  994.               ** Clear To Zero **   
  995.                             12.23  +
  996.                                12  +
  997.                                10  +
  998.                                30  +
  999.    RCVABLE                  64.23SUB
  1000.               ** Clear To Zero **   
  1001.                             23.21  +
  1002.                             19.95  +
  1003.                             23.43  +
  1004.                             19.54  +
  1005.                             12.71  +
  1006.     COST S                  98.84SUB
  1007.               ** Clear To Zero **   
  1008. M     CASH                  95.16  +
  1009. M   COST S                  98.84  -
  1010.     ASSET1                  23.21  +
  1011.     ASSET2                  11.22  +
  1012.     ASSET4                  22.22  +
  1013.                             52.97SUB
  1014.               ** Clear To Zero **   
  1015.         L1                  1,231  +
  1016.         L2                    123  +
  1017.         L3                  1,231  +
  1018.         L4                 13,123  +
  1019.         L5                    131  +
  1020.                            15,839SUB
  1021.               ** Clear To Zero **   
  1022.    CAPITAL                  2,424  +
  1023.     R EARN                 34,234  +
  1024.    NET PFT                 23,424  +
  1025.                            60,082SUB
  1026.  
  1027.  
  1028.  
  1029.  
  1030.      Remember, Adder not only saves the numbers involved in a
  1031. calculation, it also saves the calculation method. I figure things
  1032. out for a living and I hate to figure something out more than once.
  1033. With ADDER, you can figure it out once and store it away. The next
  1034. time you have to calculate it you can retrieve your method from the
  1035. disk and replace the numbers you used previously with the new
  1036. numbers. Presto, change-O, ADDER has calculated the new answer.
  1037.      What does that mean? It means that if you calculate something
  1038. (a balance sheet for example) using ADDER and save it away, then
  1039. all you have to do to recalculate that something (next month's
  1040. balance sheet) is to retrieve that something ( the balance sheet)
  1041. that you had saved away before and plug in the new numbers. The
  1042. calculation method is already there. 
  1043.      When I was doing accounting for a cemetery (no; I wasn't
  1044. counting the dead people), I wrote a program to calculate deferred
  1045. sales. With ADDER this same program could have been done in about
  1046. 1/10th the time. 
  1047.      Remember that ADDER will function as a mathematical (or more
  1048. precisely arithmetic) programming system in that the algorithm for
  1049. an ADDER calculation is saved as well as the numbers themselves.
  1050. If you then retrieve the previous calculation and change the
  1051. numbers, then the entire calculation is redone.
  1052.  
  1053.